###User Defined Function###
_WinAPI_LoadImage

###Description###
Ldt ein Icon, Cursor oder Bitmap

###Syntax###
#include <WinAPI.au3>
_WinAPI_LoadImage ( $hInstance, $sImage, $iType, $iXDesired, $iYDesired, $iLoad )


###Parameters###
@@ParamTable@@
$hInstance
	Identifiziert die Instanz des Moduls, welches das Image enthlt. Um ein OEM-Image
	zu laden, ist dieser Parameter auf Null zu setzen.
$sImage
	Identifiziert das zu ladende Image. Ist der Parameter $hInstance nicht 0 und der Parameter $iLoad enthlt
	nicht $LR_LOADFROMFILE, dann ist $sImage einen String, die den Namen der Image-Ressource aus dem Modul in
	$hInstance enthlt. Ist $hInstance 0 und $LR_LOADFROMFILE nicht festgelegt, ist in das niederwertige Wort (WORD)
	dieses Parameters der Identifizierer des zu ladenden OEM-Images einzusetzen.
$iType
	Gibt den zu ladenden Typ des Images an. Dieser Parameter kann einer der folgenden Werte sein:
	$IMAGE_BITMAP - Ldt eine Bitmap
	$IMAGE_CURSOR - Ldt einen Cursor
	$IMAGE_ICON - Ldt ein Icon
$iXDesired
	Legt die Breite (in Pixel) des Icons oder Cursors fest. Ist diese 0 und $iLoad enthlt $LR_DEFAULTSIZE, benutzt
	diese Funktion die in SM_CXICON oder SM_CXCURSOR vom System vorgegebenen Abmessungen. Ist dieser Parameter 0 und $LR_DEFAULTSIZE ist nicht
	in $iLoad gesetzt, wird die originale Breite der Ressource genutzt.
$iYDesired
	Legt die Hhe (in Pixel) des Icons oder Cursors fest. Ist diese 0 und $iLoad enthlt $LR_DEFAULTSIZE, benutzt
	diese Funktion die in SM_CYICON oder SM_CYCURSOR vom System vorgegebenen Abmessungen. Ist dieser Parameter 0 und $LR_DEFAULTSIZE ist nicht
	in $iLoad gesetzt, wird die originale Hhe der Ressource genutzt.
$iLoad
	Legt einen oder eine Kombination der folgenden Werte fest:
	$LR_DEFAULTCOLOR - Das Standard-Flag
	$LR_CREATEDIBSECTION - Wenn der $iType-Parameter $IMAGE_BITMAP angegeben ist, wird eine DIB-Bitmap anstelle einer 
	kompatiblen Bitmap (DDB) zurckgegeben. Dies ist ntzlich, wenn die geladene Bitmap nicht an den Farbraum des Anzeigegertes angepasst werden soll.
	$LR_DEFAULTSIZE - Benutzt die vom System vorgegebenen Abmessungen fr Hhe oder Breite des Cursors oder Icons, wenn
	die Werte in $iXDesired oder $iYDesired auf 0 gesetzt sind. Ist dieses Flag nicht angegeben und $iXDesired und $iYDesired
	sind auf 0 gesetzt, wird die originale Gre der Ressource genutzt. Enthlt die Ressource mehrfache Images, nutzt
	die Funktion die Gre des ersten Images.
	$LR_LOADFROMFILE - Ldt das Image aus der Datei, das in $sImage festgelegt wurde. Wenn dieses Flag nicht gesetzt ist,
	dann ist $sImage der Name der Ressource.
	$LR_LOADMAP3DCOLORS - Durchsucht die Farbtabelle fr das Image und ersetzt die folgenden Graustufen mit
	der entsprechenden 3D-Farbe:
	 Dunkelgrau: RGB(128,128,128) COLOR_3DSHADOW
	 Grau: RGB(192,192,192) COLOR_3DFACE
	 Hellgrau: RGB(223,223,223) COLOR_3DLIGHT
	$LR_LOADTRANSPARENT - Nimmt den Farbwert des ersten Pixels des Bildes und ersetzt den entsprechenden
	Eintrag in der Farbtabelle mit der Standardfarbe fr Fenster. Alle Pixel im Bild, die diesen Eintrag nutzen,
	erhalten die Standardfarbe fr Fenster. Dieser Wert beeinflusst nur Bilder, die eine dementsprechende Farbtabelle besitzen.
	Wenn $iLoad beides enthlt, also $LR_LOADTRANSPARENT und $LR_LOADMAP3DCOLORS, erhlt $LRLOADTRANSPARENT den Vorzug.
	Trotzdem wird der Farbtabelleneintrag durch COLOR_3DFACE ersetzt, nicht durch COLOR_WINDOW.
	$LR_MONOCHROME - Ldt das Image monochrom (Schwarz/Wei)
	$LR_SHARED - Teilt das Imagehandle, sollte das Bild mehrfach geladen werden. Ist $LR_SHARED nicht gesetzt,
	wird ein zweiter Aufruf von LoadImage fr dieselbe Ressource das Bild erneut laden und ein anderes Handle zurckgeben. 
	$LR_SHARED darf nicht fr Bilder benutzt werden, die keine Standardabmessungen haben, deren Gre nach dem Laden eventuell gendert
	werden soll, oder die aus einer Bilddatei geladen werden.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Das Handle zu dem Bild
Fehler:	0. Es ist _WinAPI_GetLastError() aufzurufen um erweiterte Fehlercodes zu erhalten.
@@End@@


###Remarks###
Oben genannte Konstanten bentigen #include <WinAPIConstants.au3>
Wird die Bitmap nicht mehr bentigt, sollte diese Ressource, so wie jedes GDI-Objekt, mit _WinAPI_DeleteObject wieder
freigegeben werden.

###Related###



###See Also###
@@MsdnLink@@ LoadImage
